home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 5 / BBS in a Box -Volume V (BBS in a Box) (April 1992).iso / Files / DA / H-I / HFS FindDoc < prev    next >
Encoding:
Text File  |  1986-10-07  |  8.0 KB  |  190 lines  |  [TEXT/MSWD]
  1. These instructions are for HFS Find version 1.2
  2.  
  3. Introduction
  4.  
  5.     HFS Find searches an HFS volume for files.  You may limit the search to
  6.     files that have a particular name, creator, type, or modification date, or
  7.     that reside under a specific folder.
  8.  
  9. Using HFS Find
  10.  
  11.     When you open HFS Find, a window appears.  This window contains
  12.     seven boxes for entering text, eight check buttons, and two push
  13.     buttons.
  14.  
  15.     The seven text boxes are used to tell HFS Find what files you want
  16.     to search for.  Each of these is associated with a check button,
  17.     which is located to the left of the text box.  When the check button
  18.     is checked, the text box is ACTIVE, which means that HFS Find will
  19.     use the text in the box to determine what files to show.  When the
  20.     check button is not checked, the text box is INACTIVE.  HFS Find
  21.     ignores the contents of inactive text boxes.
  22.  
  23.     The top two text boxes are used to hold a file type and a file
  24.     creator.  The next two are used to hold modification dates.  The
  25.     final three are used to hold file names.
  26.  
  27.     A file will be shown if all of the following conditions are true:
  28.  
  29.         Either the "creator" box is inactive, or the file creator matches
  30.         the contents of the "creator" box.
  31.  
  32.         Either the "type" box is inactive, or the file type matches
  33.         the contents of the "type" box.
  34.  
  35.         Either the "Older than" box is inactive, or the modification date
  36.         of the file is earlier than the date in the "Older than" box.
  37.  
  38.         Either the "Newer than" box is inactive, or the modification date
  39.         of the file is later than the date in the "Newer than" box.
  40.  
  41.         Either all the "name" boxes are inactive, or the file name matches
  42.         the contents of one of the active "name" boxes.  It doesn't have
  43.         to match exactly.  See below for more information.
  44.  
  45.     The check button labeled "Search whole disk" controls where HFS Find
  46.     looks.  If the button is checked, HFS Find will search the entire
  47.     volume.  When the button is unchecked, HFS Find will only look at
  48.     files and folders under the current folder.
  49.  
  50.     You may set the current folder by pressing the "Search From" button.
  51.     You select a file in the folder you wish to start searching from.
  52.     ( There is currently no way to select a folder directly.  If the
  53.     folder you want to start searching from contains only other folders,
  54.     there is no way to restrict the search to just that folder.  Sorry. )
  55.  
  56.     Finally, to actually start a search, press the "Do Search!" button.
  57.  
  58. Results
  59.  
  60.     When HFS Find finds a file or folder that satisfies the conditions
  61.     you specified, it will present a dialog.  At the top of the dialog
  62.     will be the name of the file or directory.  Below this is the path
  63.     name.  The path will be from the root of the volume if you searched
  64.     the entire volume, and from the current folder if you didn't.
  65.  
  66.     There are four buttons in the dialog.  The "Cancel Search" button
  67.     cancels the search.  The "Continue Search" button continues the
  68.     search.
  69.  
  70.     The "Skip Folder" button does one of two things.  If the file being
  71.     shown is a folder, then "Skip Folder" causes the search to be
  72.     resumed, but to skip any files contained in that folder.  If the
  73.     file being shown is not a folder, then "Skip Folder" causes the
  74.     search to continue, but to not show any more files from the folder
  75.     that this file is in.
  76.  
  77.     The last button, "Set Standard File Folder", sets the folder that the
  78.     standard file package uses to be the folder that the file or folder
  79.     shown is contained in.  When you select OPEN or SAVE AS from the FILE
  80.     menu in most applications, this is the folder that the OPEN or
  81.     SAVE AS dialog will start in.
  82.  
  83. Stopping a Search
  84.  
  85.     Press and hold the mouse button down during a search to abort.
  86.  
  87. Matching Names
  88.  
  89.     A file name matches the contents of a name box if the file name
  90.     starts with the characters in the name box.  For example, a name
  91.     box that contains "abc" would match files "abc", "abcd", but not
  92.     "ab".
  93.  
  94.     Four characters have special meaning in a name box.  "?" matches
  95.     with any single character of the file name.  "*" matches any
  96.     number of characters from the file name ( including zero characters ).
  97.     A "$" at the end of a name box matches the end of a file name.
  98.     Finally, ":" followed by another character matches that other
  99.     character.
  100.  
  101.     Here are some examples:
  102.         "*.h$" would match all files that end with ".h".  "*.h" would
  103.         match all files that have ".h" anywhere in their name.  "a*b?c*d?$"
  104.         would match all files whose name starts with an "a", has a "b" two
  105.         characters before a "c", and somewhere after the "c", has a "d",
  106.         one more character, and then ends.  Note that it would NOT match
  107.         a file named "abdc", because the "d" can not be used to match both
  108.         "b?c" and "d?".  
  109.  
  110. Dates
  111.  
  112.     The two boxes that accept dates accept three formats.  The first
  113.     consists of a date and time.  The date is either MONTH/DAY or
  114.     MONTH/DAY/YEAR, where MONTH is a number from 1 to 12, DAY is a
  115.     number from 1 to 31, and YEAR is the year.  If YEAR is less than
  116.     1900, 1900 is added.  If you use the MONTH/DAY from then the year
  117.     will be the current year.  The time is HOUR:MINUTE, where HOUR is
  118.     a number from 0 to 23, and MINUTE is from 0 to 59.  The time may
  119.     either come before or after the date.  Seperate the time and date
  120.     with a space.
  121.  
  122.     If you give a date but no time, the time is 00:00.  If you give
  123.     a time but no date, the date is the date you next press "Do Search!"
  124.  
  125.     For example, if the current date is 9/23/86, the following would
  126.     all be valid ways to specify 3:30 PM on 9/23/86: "15:30", "15:30 9/23",
  127.     "9/23/1986 15:30", "9/23/86 15:30".
  128.  
  129.     You may instead specify the number of minutes, hours, or days before
  130.     the current date and time.  You do this be entering a minus sign,
  131.     the number of mintues, hours, or days, and an M, H, or D ( or m, h, or
  132.     d ).  For example, -12h would mean 12 hours before the time the
  133.     "Do Search!" button is pressed.  -7D would mean 7 days.
  134.  
  135.     You may also simply specify the number of seconds since Jan 1, 1904
  136.     ( let's hear it for useless features! )
  137.  
  138. Another Way to Enter Things in the Type, Creator, and Date Boxes.
  139.  
  140.     If you press the command key and click the mouse button in one of
  141.     these boxes, you will be presented with a dialog that lets
  142.     you select a file.  The type, creator, or date will be set to
  143.     match the file you select.
  144.  
  145. An Example
  146.  
  147.     We desire to find all MacWrite files whose name starts with "Report"
  148.     or "Chapter".
  149.  
  150.     Type "macwrite" into a name box.  Make that the only active box.  We
  151.     then search the whole disk to find MacWrite.  When we find it, we
  152.     press "Set SFGetFile directory", and then "Cancel Search".
  153.  
  154.     Now we command click in the "creator" box.  We select MacWrite from
  155.     the list of files shown.  "MACA" appears in the "creator" box.
  156.  
  157.     Enter "report" in a name box, and "chapter" in another name box.
  158.     Make those name boxes active.  Also make the creator box active.
  159.     Press "Do Search".
  160.  
  161. Another Example
  162.  
  163.     We want to decide if it is time to do a backup of our hard disk.
  164.     We did our last backup 7 days ago.
  165.  
  166.     Open HFS Find.  Type "-8d" ( eight rather than seven to be safe )
  167.     into the "Newer Than" box.  Activate it by checking it's check box.
  168.  
  169.     Deactivate all the other boxes.  Make sure "Search whole disk" is
  170.     checked.
  171.  
  172.     Press search.
  173.  
  174.     You will see all files you have diddled with since your backup.
  175.  
  176. Program Limits
  177.  
  178.     Folders more than 32 levels below the folder the search starts in
  179.     will be skipped.  You will be told when HFS Find is going to have
  180.     to skip some folders.
  181.  
  182.     The path name for a file can not exceed about 1200 characters.  If
  183.     it does, the world will end.  You should hit the depth limit before
  184.     you hit this one.
  185.  
  186.     No text box should contain more than about 35 characters.
  187.  
  188.     HFS Find *seems* to work on MFS volumes also, although it was not
  189.     meant to do so.  That it does may be considered an accident.
  190.